<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<title>RemoteAntCall Task</title>
<link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
</head>

<body>

<h2><a name="antcall">RemoteAntCall</a></h2>
<h3>Description</h3>

<p>Execute the specified target of the specified ant build file on the remote host or hosts. </p>

<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
  <tr>
    <td valign="top"><b>Attribute</b></td>
    <td valign="top"><b>Description</b></td>
    <td align="center" valign="top"><b>Required</b></td>
  </tr>
  <tr>
    <td valign="top">hostref</td>
    <td valign="top">reference a remote host.if hostref or hostsetref both not specified, the command will execute locally </td>
    <td valign="top" align="center">NO</td>
  </tr>
  <tr>
    <td valign="top">hostsetref</td>
    <td valign="top">reference remote hosts. if hostref or hostsetref both not specified, the command will execute locally </td>
    <td valign="top" align="center">NO</td>
  </tr>
  <tr>
    <td valign="top">buildfile</td>
    <td valign="top">the ant build file on the remote host. if the build file is not set to absolute dir, the host based dir will be insterted before the build file. </td>
    <td align="center" valign="top">YES</td>
  </tr>
  <tr>
    <td valign="top">target</td>
    <td valign="top">the executing target in the buildfile.</td>
    <td align="center" valign="top">YES</td>
  </tr>
  <tr>
    <td valign="top">transmit</td>
    <td valign="top">whether or not transmit the command to the remote host, default value is YES, if set to NO, just print the command in standard output. </td>
    <td align="center" valign="top">No</td>
  </tr>
</table>

<h3>Parameters specified as nested elements</h3>

<h4>param</h4>
<p>Specifies the properties to set before running the specified target. See <a
href="property.html">property</a> for usage guidelines.</p>

<h4>Examples</h4>
<pre>&lt;target name=&quot;rantcall&quot;&gt;<br>   &lt;remoteantcall hostref=&quot;greatwall&quot; buildFile=&quot;${resouces.dir}/ping.xml&quot; target=&quot;ping&quot;&gt;
      &lt;param name=&quot;para&quot; value=&quot;localhost&quot;/&gt;<br>   &lt;/remoteantcall&gt;<br>&lt;/target&gt;</pre>
<p>Execute the target <strong>ping</strong> on <strong>greatwall</strong> in ${resouces.dir} directory. Pass through the according parameters. </p>
<hr><p align="center">Copyright &copy; 2005 Dant Organization. All rights Reserved.</p>

</body>
</html>
